<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1988-2023 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "Funding Free Software", the Front-Cover
Texts being (a) (see below), and with the Back-Cover Texts being (b)
(see below).  A copy of the license is included in the section entitled
"GNU Free Documentation License".

(a) The FSF's Front-Cover Text is:

A GNU Manual

(b) The FSF's Back-Cover Text is:

You have freedom to copy and modify this GNU Manual, like GNU
     software.  Copies published by the Free Software Foundation raise
     funds for GNU development. -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Stack Smashing Protection (GNU Compiler Collection (GCC) Internals)</title>

<meta name="description" content="Stack Smashing Protection (GNU Compiler Collection (GCC) Internals)">
<meta name="keywords" content="Stack Smashing Protection (GNU Compiler Collection (GCC) Internals)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html" rel="start" title="Top">
<link href="Option-Index.html" rel="index" title="Option Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Stack-and-Calling.html" rel="up" title="Stack and Calling">
<link href="Miscellaneous-Register-Hooks.html" rel="next" title="Miscellaneous Register Hooks">
<link href="Shrink_002dwrapping-separate-components.html" rel="prev" title="Shrink-wrapping separate components">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<span id="Stack-Smashing-Protection"></span><div class="header">
<p>
Next: <a href="Miscellaneous-Register-Hooks.html" accesskey="n" rel="next">Miscellaneous Register Hooks</a>, Previous: <a href="Shrink_002dwrapping-separate-components.html" accesskey="p" rel="prev">Shrink-wrapping separate components</a>, Up: <a href="Stack-and-Calling.html" accesskey="u" rel="up">Stack and Calling</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<span id="Stack-smashing-protection"></span><h4 class="subsection">18.9.15 Stack smashing protection</h4>
<span id="index-stack-smashing-protection"></span>

<dl>
<dt id="index-TARGET_005fSTACK_005fPROTECT_005fGUARD">Target Hook: <em>tree</em> <strong>TARGET_STACK_PROTECT_GUARD</strong> <em>(void)</em></dt>
<dd><p>This hook returns a <code>DECL</code> node for the external variable to use
for the stack protection guard.  This variable is initialized by the
runtime to some random value and is used to initialize the guard value
that is placed at the top of the local stack frame.  The type of this
variable must be <code>ptr_type_node</code>.
</p>
<p>The default version of this hook creates a variable called
&lsquo;<samp>__stack_chk_guard</samp>&rsquo;, which is normally defined in <samp>libgcc2.c</samp>.
</p></dd></dl>

<dl>
<dt id="index-TARGET_005fSTACK_005fPROTECT_005fFAIL">Target Hook: <em>tree</em> <strong>TARGET_STACK_PROTECT_FAIL</strong> <em>(void)</em></dt>
<dd><p>This hook returns a <code>CALL_EXPR</code> that alerts the runtime that the
stack protect guard variable has been modified.  This expression should
involve a call to a <code>noreturn</code> function.
</p>
<p>The default version of this hook invokes a function called
&lsquo;<samp>__stack_chk_fail</samp>&rsquo;, taking no arguments.  This function is
normally defined in <samp>libgcc2.c</samp>.
</p></dd></dl>

<dl>
<dt id="index-TARGET_005fSTACK_005fPROTECT_005fRUNTIME_005fENABLED_005fP">Target Hook: <em>bool</em> <strong>TARGET_STACK_PROTECT_RUNTIME_ENABLED_P</strong> <em>(void)</em></dt>
<dd><p>Returns true if the target wants GCC&rsquo;s default stack protect runtime support,
otherwise return false.  The default implementation always returns true.
</p></dd></dl>

<dl>
<dt id="index-TARGET_005fSUPPORTS_005fSPLIT_005fSTACK">Common Target Hook: <em>bool</em> <strong>TARGET_SUPPORTS_SPLIT_STACK</strong> <em>(bool <var>report</var>, struct gcc_options *<var>opts</var>)</em></dt>
<dd><p>Whether this target supports splitting the stack when the options
described in <var>opts</var> have been passed.  This is called
after options have been parsed, so the target may reject splitting
the stack in some configurations.  The default version of this hook
returns false.  If <var>report</var> is true, this function may issue a warning
or error; if <var>report</var> is false, it must simply return a value
</p></dd></dl>

<dl>
<dt id="index-TARGET_005fGET_005fVALID_005fOPTION_005fVALUES">Common Target Hook: <em>vec&lt;const char *&gt;</em> <strong>TARGET_GET_VALID_OPTION_VALUES</strong> <em>(int <var>option_code</var>, const char *<var>prefix</var>)</em></dt>
<dd><p>The hook is used for options that have a non-trivial list of
possible option values.  OPTION_CODE is option code of opt_code
enum type.  PREFIX is used for bash completion and allows an implementation
to return more specific completion based on the prefix.  All string values
should be allocated from heap memory and consumers should release them.
The result will be pruned to cases with PREFIX if not NULL.
</p></dd></dl>

<hr>
<div class="header">
<p>
Next: <a href="Miscellaneous-Register-Hooks.html" accesskey="n" rel="next">Miscellaneous Register Hooks</a>, Previous: <a href="Shrink_002dwrapping-separate-components.html" accesskey="p" rel="prev">Shrink-wrapping separate components</a>, Up: <a href="Stack-and-Calling.html" accesskey="u" rel="up">Stack and Calling</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Option-Index.html" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
